home *** CD-ROM | disk | FTP | other *** search
/ Aminet 23 / Aminet 23 (1998)(GTI - Schatztruhe)[!][Feb 1998].iso / Aminet / disk / misc / Rigids.lha / Rigids / Rigids.doc < prev   
Text File  |  1997-12-14  |  7KB  |  183 lines
  1.  
  2. Short: Backup and restore RDB along with data before it.
  3.  
  4.  
  5.                             Rigids v1.0 beta
  6.                          © 1997 by Tadek Knapik
  7.  
  8.  
  9.     *** The most important part - what is it for?
  10.  
  11.     This program lets you backup your RigidDiskBlock along with
  12. possible data placed before it. This means it will help you when you,
  13. like me, have an Amiga hard disk with a fully-qualified pc-partition. On
  14. block 0 there is pc MBR (Master Boot Record), and Amiga RDB starts on
  15. block 3. Rigids by default saves to a file all data from block 0 to the
  16. end of RDB data. And it can restore it, if course :)
  17.     It can also backup only RDB, or start backup at specified
  18. offset. When restoring, default action is to write data from the file
  19. exactly to where it was on the disk. But you can choose to write only
  20. RDB at specified offset as well.
  21.     Still considered beta, because I hadn't too many volounteers for
  22. betatesting :))
  23.     Some lines below you will find the template, at the end of the
  24. docs there are some examples.
  25.  
  26.  
  27.  
  28.     *** The part no one ever reads.
  29.  
  30.     This program is let's-say-freeware. Freeware means you have
  31. right to use it, spread it etc. as you want, but you have no right to
  32. modify it. This is about the binary, source and docs. Let's-say means
  33. that if you take part of the source and use it in your program, I
  34. probably won't even think bad of you (well, you should notice my name
  35. somewhere:) I wouldn't like modyfying it and spreading with this name,
  36. or under my name, that's all. If you want to make this program better,
  37. e-mail me you suggestions, or just send me source of your modyfications
  38. to it, and I will take care. And.. Oh er, enough of this stuff...
  39.     I would appreciate a postcard or sth in this kind if it helped
  40. you much, that's the more important thing in this copyright stuff:))
  41.  
  42.     Oh, I almost forgot ;) I am not responsible for any damages this
  43. program causes, use it at your risk etc. It is tested not to make your
  44. fridge blow up, but... you never know ;)
  45.     Hmm, but seriously. If I had mistaken, you wouldn't be very
  46. happy (would you?:). Use it carefully.
  47.  
  48.  
  49.     *** The part almost no one reads, but everyone should.
  50.  
  51.     By default, the proggy searches for RDB start on first 16 blocks
  52. of the device. When it finds it, it reads to a file all data from block
  53. 0 to the end of RDB. When writing, it searches for start of RDB in the
  54. file (on first 16 "blocks"), and writes the data just where it was
  55. before. There are some things in this behaviour you can change.
  56.     The template is:
  57.  
  58.  D=DEVICE/K,U=UNIT/K/N,O=OFFSET/K/N,RDB=RDBONLY/S,WRITE/S,FORCE/S,F=FILE/A
  59.  
  60.  
  61.     D=DEVICE/K,U=UNIT/K/N
  62.  
  63.    Default values for DEVICE and UNIT are scsi.device unit 0.
  64.  
  65.  
  66.     WRITE/S
  67.  
  68.    If you don't specify this, the program will read data to a file. If
  69. you do, it will write data from a file to the disk.
  70.  
  71.  
  72.     FORCE/S
  73.  
  74.    All RDB data structures are checksummed. If the checksum is wrong,
  75. Rigids will deny to do anything. But you can FORCE it to do what you
  76. want.
  77.    Note, that Rigids has to find RDB first :) When you have no RDB, it
  78. won't do anything. Even FORCED to :))
  79.  
  80.  
  81.     RDB=RDBONLY/S
  82.  
  83.    Instead of taking care of all data, you can process only RDB. It
  84. means that (on reading) all stuff before RDB on the disk is ignored, and
  85. the file is filled only with RDB. On writing, only RDB data is written
  86. to the disk (just in place where it was when backing up).
  87.  
  88.  
  89.     O=OFFSET/K/N
  90.  
  91.    Here you choose where Rigids should start to search for RDB on the
  92. disk. Also, it will start the backup begginnig from this block (unless
  93. RDBONLY is specified).
  94.    When restoring, giving OFFSET tells Rigids to pick up from the file
  95. only RDB data (it toggles on RDBONLY option automatically) and save it
  96. beginning at given block.
  97.    Valid range is from 0 to 15.
  98.    This is rarely needed, but may help for example when you are writing
  99. MBR's from an old backup (or creating it in some way), and then have to
  100. write RDB which was on block 0 before.
  101.  
  102.     F=FILE/A
  103.  
  104.    Quite obvius - where to save or from where to read.
  105.    But watch out for WRITE flag - easier than to give it is to _forget_
  106. to give it. Then you overwrite the valid data in your file with
  107. (probably messed up) RDB from your hard disk. I managed to do it, and
  108. then had a lot of "fun" putting everything altogether.
  109.  
  110.  
  111.     *** The part you will sure look at.
  112.  
  113.     Here are some examples of use Rigids:
  114.  
  115.  Rigids Work:Backup/TadekRDB       - saves data to the end of RDB
  116.  
  117.  Rigids RDBONLY Work:Backup/TadekRDB  - saves RDB to a file
  118.  
  119.  Rigids WRITE Work:Backup/TadekRDB - restores all data from a file
  120.  
  121.  Rigids device=gvpscsi.device unit=2 ram:RDB   - backup to the end of RDB
  122.  
  123.  Rigids OFFSET=2 Trash:RDBFile     - backups from block 2 to the end
  124.  
  125.  Rigids WRITE RDBONLY ram:RDBetc   - picks up RDB and writes it where it was
  126.  
  127.  Rigids WRITE OFFSET=0 ram:RDBetc  - picks up RDB and writes it at block 0
  128.  
  129.  Rigids FORCE Trash:MessyRDB       - backups even if cheksum is wrong
  130.  
  131.  Rigids WRITE FORCE ram:MungledRDB - restores data even if checksum is wrong
  132.  
  133.     Hope you got the idea :)
  134.  
  135.  
  136.  
  137.     *** The part authors write when they're happy they did it.
  138.  
  139.     Well, sorry for unconsistence of those docs. As my friend says,
  140. this is the worst part of the program :))
  141.     Here I want to thank David Balazic for his RDB-Informer. It
  142. helped me really much, both by possiblity to see some source code
  143. reading RDB, and by providing a way to check if I write the data
  144. correctly. Also, in my proggy I used a few of his routines, which were
  145. very good start for me to write the source :)) If you'd like to know
  146. what RDB is all about, how it looks like etc, I encourage to use the
  147. RDB-Informer :)
  148.     And if you decide to write me a postcard or an e-mail, write to
  149. him, too :)) His address is David.Balazic@uni-mb.si. Thanks David :))
  150.  
  151.     I would also like to mention Gérard Cornu, the author of
  152. ReadRDB, which was very helpful until I managed to make my hard disk a
  153. hybrid :)
  154.  
  155.  
  156.     *** Last words
  157.  
  158.      So, you have the proggy. You have the source, too. Hope you'll
  159. find both useful. On the other side, the best way would be not to need
  160. such programs :)
  161.     Future plans are to accept VERBOSE swicth and then print some
  162. info about the RDB. Maybe even recognizing MBR (and printing info as
  163. well). If I have docs on it :)
  164.     Bug reports, flames, thanks, letters, postcards appreciated.
  165. It is always nice to know you didn't send your program to /dev/null :))
  166.  
  167.  
  168.     Tadek Knapik.
  169.     14th of December 1997, Cracow.
  170.  
  171.  
  172.         E-mail: tadek@malenstwo.iinf.polsl.gliwice.pl
  173.  
  174.     Snail-mail:
  175.         ul. Duza Gora 35/88
  176.         30-857 Cracow
  177.     Poland
  178.  
  179.  
  180.     "Be yourself, no matter what they say" - Sting
  181.  
  182.  
  183.